Localizarea este, în general, procesul de furnizare a unui Software cu o interfață de utilizare în mai multe limbi. În FreeCAD puteți seta limba interfeței de utilizator sub Editare → Preferințe → Aplicație . FreeCAD utilizează Qt pentru a activa suportul pentru mai multe limbi. Pe sistemele Unix / Linux, FreeCAD utilizează implicit setările locale locale ale sistemului.
Localisation is in general the process of providing a Software with a multiple language user interface. In FreeCAD you can set the language of the user interface under Edit → Preferences → General. FreeCAD uses Qt to enable multiple language support. On Unix/Linux systems, FreeCAD uses the current locale settings of your system by default.
Unul dintre lucrurile foarte importante pe care utilizatorii le poate contribui la FreeCAD (dacă, de exemplu, nu au abilități de programare) este de a ajuta la traducerea diferitelor sale aspecte (cod sursă, wiki, site web, documentație etc.) într-o altă limbă. Iată modalitățile de a face acest lucru
FreeCAD folosește un sistem de traducere on-line, bazat pe colaborare, numit Crowdin. Este software proprietate, dar gratuit pentru proiectele FOSS. Mai jos sunt instrucțiuni despre modul de utilizare:
FreeCAD utilizes a third party collaborative on-line translation system called Crowdin.
It is proprietary software but free to FOSS projects. Below are instructions on how to use it:
Dacă participați în mod activ la traducerea FreeCAD și doriți să fiți informat înainte de lansarea următoarei versiuni, atunci când este gata să fie lansată, deci este timpul să vă revizuiți traducerea, vă rugăm să vă abonați la una dintre echipele de traducere Crowdin FreeCAD.
Note: Details on how to use crowdin can be found on the Crowdin Administration page.
Visit Translating an external workbench.
Starting with FreeCAD 0.20, the following variables can be manually added to the BaseApp/Preferences/General section of the user.cfg file to assist with the development of new translations:
AdditionalLanguageDomainEntries - to add entirely new languages to FreeCAD that are not currently supported by the source code, you can use this user preference to add to the list of available languages. The format of the languages is "Language Name"="code"; for example:
<FCText Name="AdditionalLanguageDomainEntries">"Esperanto"="eo";"French"="fr";</FCText>
AdditionalTranslationsDirectory - add an additional directory for FreeCAD to search for *.qm files. This location will take precedence over $userAppDataDir/translations and $resourceDir/translations. For example:
<FCText Name="AdditionalTranslationsDirectory">C:/Users/FreeCADUser/TestTranslations</FCText>
Acest wiki găzduiește o multitudine de conținuturi, majoritatea cărora construiesc manualul. Puteți căuta documentația pornind de la Main Page, or have a look at the User's manual Online Help Toc.
Pentru a traduce în wiki, trebuie să aveți permisiunea Cum pot obține permisiunea de a edita pe wiki?.
Ar trebui să aveți, de asemenea, suficiente cunoștințe despre marcajul wiki și să urmați liniile generale de orientare descrise în WikiPages.
Când wiki-ul s-a mutat de la SourceForge, Yorik a instalat extensia de traducere a MediaWiki's Translation extension care facilitează traducerea paginilor. Avantajele extensiei de traducere sunt că titlul paginii poate fi acum tradus, se ține evidența traducerilor, se notifică dacă pagina inițială a fost actualizată și se mențin traducerile sincronizate cu pagina originală în limba engleză.
Instrumentul este documentat în Help:Extension:Translate, și este partea a MediaWiki Language Extension Bundle.
Pentru a începe rapid să pregătiți o pagină pentru traducere, citiți textulPage translation example. Essentially, a pair of
<translate> ... </translate>
etichetele trebuie să înconjoară întreaga pagină pentru a activa sistemul de traducere, iar pagina trebuie marcată pentru traducere.
Pentru a vedea un exemplu de funcționare a instrumentului de traducere odată ce plugin-ul de traducere este activat pe o pagină, accdesați Main Page.Veți vedea o bară de limbă generată automat în partea de sus. Faceți clic pe Deutsch (germană), vă va duce la Main Page/de. În dreptul titlului, puteți citi "Această pagină este o versiune tradusă a Paginii Principale a paginii și traducerea este XX% completă", XX fiind procentul efectiv al traducerii. Faceți clic pe "Traduceți" în partea de sus a paginii pentru a porni utilitarul de traducere pentru a actualiza, corecta și revizui traducerea existentă.
Dacă mergeți la Main Page/de, veți observa că nu mai puteți edita direct pagina făcând clic pe etichetele [Editare], iar linkul de sus "Editare" a fost înlocuit cu linkul "Traduceți" care deschide utilitarul de traducere.
Când se adaugă conținut nou, pagina de engleză trebuie creată mai întâi, apoi tradusă în altă limbă. Dacă cineva dorește să schimbe sau să adauge conținut într-o pagină, pagina în limba Engleză ar trebui să fie prima modificată.
Dacă nu sunteți siguri cum să continuați cu traducerile, nu ezitați să cereți ajutor în subforumul Develpment/Wiki sau în subforumuol specific al limbii în FreeCAD forum.
Fiecare utilizator wiki care are permisiuni "Editor" este capabil să lanseze utilitatea de traducere și să scrie, să salveze și să revizuiască traducerile.
Cu toate acestea, numai utilizatorii cu permisiuni "Administrator" pot marca paginile pentru traducere. O pagină care nu este marcată pentru traducere nu va utiliza extensia de traducere și nu va fi sincronizată corect cu informațiile din limba engleză.
Bara laterală din stânga este, de asemenea, translatabilă, dar numai administratorii pot modifica acest element al site-ului. Urmați instrucțiunile dedicate din paginaLocalisation Sidebar .
Prima dată când comutați o pagină în noul sistem de traducere, aceasta își pierde toate vechile traduceri "manuale". Pentru a recupera o traducere, ar trebui să salvați o copie offline a vechiului text înainte de comutatore. Apoi puteți utiliza acest vechi text tradus pentru a completa unitățile de traducere în noul sistem. De asemenea, puteți deschide o versiune anterioară din istoric și puteți obține vechiul text în acest fel. Acest lucru trebuie făcut pentru fiecare limbă care a avut o pagină tradusă.
As per general consensus, the reference page in the wiki is the English page, which should be created first. If you want to change or add content to a page, you should do it to the English page first, and only once the update is completed, port the modification to the translated page.
Deci, primul pas este să verificați dacă traducerea manuală a fost deja pornită pentru limba dvs. (vedeți în bara laterală stângă, sub "manual").
Pagina de numire a Convenției
#REDIRECT [[About FreeCAD/fr]]
{{docnav/fr|Bienvenue sur l'aide en ligne|Fonctionnalités}} Pagina "Bienvenue sur l'aide en ligne" se redirecționează către pagina Online Help Startpage/fr, iar pagina "Fonctionalités" redirecționează către Feature list/fr. |
Traducerea site-ului FreeCAD se face acum prin intermediul Crowdin. Fișierul este denumit homepage.po.
Translation of the FreeCAD website is now done through Crowdin. The file is named homepage.po.
Această secțiune este destinată dezvoltatorilor care doresc să adauge localizare codului lor.
This section is for developers who want to add localisation to their code.
Acestea sunt părțile la procesul de traducere a FreeCAD:
These are the parts to the FreeCAD translation process:
Toți pașii de mai sus sunt realizați prin "scripturile de traducere", care sunt gestionate periodic de un administrator.
Pregătirea modulului dvs. pentru traducere este destul de ușoară. În primul rând, trebuie să vă asigurați că aveți un director de "traduceri" în MyModule / Gui / Resources. Apoi deschideți o fereastră terminală (sau echivalent Windows / OSX) în directorul "traduceri" și introduceți următoarea comandă:
lupdate -ts myModule.ts
Aceasta creează un fișier de traducere gol. Odată ce acest lucru este făcut, trebuie să vă asigurați că scripturile de traducere sunt actualizate ca în acesta pull request.
Totul după acest lucru este automat în ceea ce privește un dezvoltator. Administratorul va extrage șirurile de text, traducătorii îi vor traduce, apoi administratorul va extrage traducerile și va actualiza FreeCAD / master.
Modulele sau macro-urile de la terțe părți sunt traduse în aceeași manieră, cu excepția faptului că trebuie să faceți o parte din munca dumneavoastră. Această adresă forum discussion descrie detaliile.
3rd party modules or macros are translated in much the same fashion, except that you must do some of the work yourself. This forum discussion describes the details.
Update: see Translating an external workbench
În prezent, administratorii FreeCAD utilizează API-ul Crowdin prin Crowdin Scripts pentru a trage și împinge traducerile în Crowdin și înapoi la repo Github. API-ul Crowdin oferă administratorilor FreeCAD capacitatea de a automatiza aspectele fluxului de lucru al proiectului, pentru mai multe informații, consultați documentația Crowdin API.
Currently FreeCAD maintainers use the Crowdin API via Crowdin Scripts to pull and push translations in to Crowdin and back in to the Github repo. The Crowdin API gives FreeCAD maintainers the ability to automate aspects of the project's translation workflow, for more info refer to the Crowdin API documentation.
See also: FreeCAD Scripting Basics.
To get a dictionary with the languages the FreeCAD interface supports, use the supportedLocales
method of the FreeCADGui
module.
locales = FreeCADGui.supportedLocales()
After execution locales
will contain:
{'English': 'en', 'Afrikaans': 'af', 'Arabic': 'ar', 'Basque': 'eu', 'Catalan': 'ca', 'Chinese Simplified': 'zh-CN', 'Chinese Traditional': 'zh-TW', 'Croatian': 'hr', 'Czech': 'cs', 'Dutch': 'nl', 'Filipino': 'fil', 'Finnish': 'fi', 'French': 'fr', 'Galician': 'gl', 'German': 'de', 'Hungarian': 'hu', 'Indonesian': 'id', 'Italian': 'it', 'Japanese': 'ja', 'Kabyle': 'kab', 'Korean': 'ko', 'Lithuanian': 'lt', 'Norwegian': 'no', 'Polish': 'pl', 'Portuguese': 'pt-PT', 'Portuguese, Brazilian': 'pt-BR', 'Romanian': 'ro', 'Russian': 'ru', 'Slovak': 'sk', 'Slovenian': 'sl', 'Spanish': 'es-ES', 'Swedish': 'sv-SE', 'Turkish': 'tr', 'Ukrainian': 'uk', 'Valencian': 'val-ES', 'Vietnamese': 'vi'}
To get the current interface language use the getLocale
method of the same module:
locale = FreeCADGui.getLocale()
If the current language is English locale
will contain:
'English'
To get the corresponding language code you can use use:
locale = FreeCADGui.supportedLocales()[Gui.getLocale()]
If the current language is English the result will be:
'en'
To set the current interface language use the setLocale
method of the same module. You can specify the language or the language code:
FreeCADGui.setLocale('Russian')
FreeCADGui.setLocale('ru')